home *** CD-ROM | disk | FTP | other *** search
/ Acorn User: China / Acorn User China CD-ROM (UK) (Disc A) / Acorn User China CD-ROM (UK) (Disc A).bin / HENSA / CONVERTER / WMF.TXT < prev    next >
Encoding:
Text File  |  1999-03-12  |  7.3 KB  |  259 lines
  1.                       
  2.                             CAREWARE
  3.                      
  4.  
  5.                         BETA TEST VERSION.                      
  6.  
  7.  
  8.                   !WMF->Draw Version 1.9 Readme.
  9.  
  10.  
  11.          THIS PROGRAM IS CAREWARE IS IS NOT PUBLIC DOMAIN
  12.                                         ~~~
  13. This program may be freely distributed as long as it is not altered
  14. in any way. That there is no charge other than distribution cost.
  15.  
  16. However if you do find it useful then please send a donation to.
  17.  
  18.  
  19.     Heatherley Cheshire Home
  20.     Effingham Lane,
  21.     Copthorne,
  22.     Sussex.
  23.     RH10 3HS.
  24.  
  25. Registered Charity Number : 218186
  26.  
  27. This version supplied by Akalat Publishing with permission of Keith Sloan.
  28.  
  29.  
  30. Acknowledgements
  31. ~~~~~~~~~~~~~~~~
  32.  
  33. Thanks to following for suppling some test cases.
  34.  
  35.  
  36.  Brian Cowan, Keith Milner, Ian Roberts, Vic.
  37.  
  38. Last updated 
  39. ~~~~~~~~~~~~
  40.    Application   : 7th Oct    1997
  41.    Documentation : 2nd March  1996
  42.                                        
  43.                       
  44. !WMF->Draw is a Utility for converting Windows Metafiles to Draw
  45.  
  46. This version supports only a subset of Windows Metafile Graphics orders.
  47. If you have files that will not convert please contact the Author as I
  48. am always interested in new test cases and in expanding the program. If
  49. possible please supply small diagram with the problem as these are a
  50. lot easier to debug. 
  51.  
  52.  
  53. Installation
  54. ~~~~~~~~~~~~
  55. The WMF->Draw arc file should have been restored to a directory named
  56. !WMF->Draw. Which should contain the following files :-
  57.  
  58.  
  59.            !Run        : WMF->Draw Startup file.
  60.            !Sprites    : WMF->Draw Application Sprites
  61.            Templates   : Template files
  62.            wmfdraw     : WMF->Draw Application.
  63.            ~~config    : Configuration file for WMF->Draw. 
  64.            !Help       : This file.
  65.  
  66. Tailoring.
  67. ~~~~~~~~~~
  68.  
  69.     The !run file should be altered to suite your requirements :-
  70.  
  71.  
  72.     Modules required :-
  73.  
  74.        The Shared C Library should be loaded as appropriate for
  75.        your setup. The supplied !run file assumes that the C
  76.        shared library module is in !system.modules.
  77.  
  78.        The Floating Point Emulator should be loaded as appropriate for
  79.        your setup. The supplied !run file assumes that the FPEmulator
  80.        module is in !system.modules.  
  81.                        
  82.     Variables required :-
  83.  
  84.        WMFDraw$Dir is required in order for WMF->Draw to find its various
  85.        configuration files.
  86.  
  87.     Storage required :-
  88.  
  89.        !WMF->Draw has been tested with a wimpslot size of 160k
  90.        on a machine with 32k pages. lower values may be possible
  91.        on machines with smaller page sizes.
  92.  
  93.        The file to be converted is loaded into a buffer claimed from
  94.        the next slot. The space is return immediately after the conversion,
  95.        so you should not be able to see the change.
  96.        
  97.        If !WMF->Draw  prompts that it does not have enough memory to process, 
  98.        then !WMF->Draw must be restarted, having made provision that 
  99.        the next slot is large enough.     
  100.  
  101. Operation.
  102. ~~~~~~~~~~
  103.  
  104.      1) First click on the !WMF->Draw icon. This will install the !WMF->Draw
  105.         icon on the icon bar.
  106.  
  107.      2) To convert a WMF file (or EPS file with WMF preview section),
  108.         drag the file to the !WMF->Draw icon on the icon bar.
  109.         This will popup a save Draw window. Drag the Draw
  110.         file icon to the required destination. 
  111.  
  112. Windows BMP Files
  113. ~~~~~~~~~~~~~~~~~
  114.  
  115.       As WMF files may contain objects with BMP bitmaps a side effect of
  116.       !WMF->Draw is that BMP files maybe converted to a Draw file containing
  117.       a sprite. The BMP files must be of type 0x69C.
  118.  
  119.  
  120. Control Options
  121. ~~~~~~~~~~~~~~~
  122.                                                  
  123.       Direct Link
  124.       -----------
  125.  
  126.       Rather than have !WMF->Draw prompt for the target file, it is possible
  127.       to set a default path and have the target name created as default path
  128.       plus filename. To do this you drag the Draw file icon to the target
  129.       directory or application and set the Direct option. With the direct
  130.       option set the output Draw file will automatically be created.
  131.  
  132.       Note; To use this option directly with an application then the
  133.            receiving application must support the Draw file type.
  134.  
  135.               
  136. Current Restrictions
  137. ~~~~~~~~~~~~~~~~~~~~      
  138.       
  139.       WMF related
  140.       -----------
  141.  
  142.       Only a subset of Graphics orders currently supported.
  143.  
  144.  
  145. Config File
  146. ~~~~~~~~~~~
  147.   
  148.   The format of the config file is
  149.  
  150.      List of Draw fonts 
  151.      
  152.      ## terminator
  153.  
  154.      List of WMF fonts with corresponding Draw font number
  155.      Font baseline Percentage 
  156.  
  157.      i.e if baseline is at 20% of font height input 20.
  158.  
  159.      Baseline for Default font is hardcoded 20%
  160.       
  161. WMF File type
  162. ~~~~~~~~~~~~~
  163.  
  164.        The WMF file type is B2F
  165.  
  166.  
  167. Copyright & Contributions
  168. ~~~~~~~~~~~~~~~~~~~~~~~~~
  169.  
  170. This software carries no warranty, either express or implied. 
  171. I can not guarantee that it is free of bugs or give any warranty
  172. about it’s suitability for use.
  173.                                                    
  174. The status of !WMF->Draw is Careware. However it may be freely
  175. distributed.
  176.  
  177.  
  178. Copyright remains solely the authors. (C) Keith Sloan 
  179.  
  180. Contact
  181. ~~~~~~~
  182.  
  183. If you find problems or want to make suggestions for improvements then
  184. please contact me at either of the following.
  185.  
  186.  Internet : keiths@cix.compulink.co.uk
  187.  
  188. Wanted
  189. ~~~~~~
  190.  
  191. The quality of PD/Careware/Shareware depends on users reporting bugs
  192. and obtaining upto date versions, so before you bemoan the quaility
  193. check the date the software was created and please report bugs.
  194.  
  195. Next time you see a reviewer, give them some stick on not
  196. reporting which version that are slating.
  197.                    
  198. In the interest of enhancing this enhance this application I
  199. would like to obtain the following :-
  200.  
  201.     Sample WMF files that fail to convert correctly
  202.  
  203. Many Thanks
  204.                     
  205.  
  206.  
  207. Version History.
  208. ~~~~~~~~~~~~~~~~    
  209.           
  210.      Beta 1.0 : Version supplied to M Roscoe.
  211.  
  212.      Beta 1.1 : 3rd Jan 1993
  213.  
  214.         Converts all sample WMF files at present.
  215.  
  216.      Beta 1.2 : 5th Jan 1993
  217.  
  218.         Fixes for text output and use of config file
  219.  
  220.      Beta 1.3 : 29th Jan 1993
  221.  
  222.        Some bit maps operations supported.
  223.  
  224.      Beta 1.4 : 4th April 1993
  225.  
  226.        Fix for default font height.
  227.        support WMF Preview section of EPS files
  228.  
  229.      Beta 1.5 : 6th April 1993
  230.  
  231.        Fix for padding in text.
  232.        support loading of BMP files.
  233.  
  234.      1.6      : 7th Feb 1995
  235.  
  236.        fix for polypolgon
  237.        allow for base line in font alignment
  238.                             
  239.      1.7/1.7a : 28th Jan 1996
  240.  
  241.        set text alignment supported.
  242.        Only allow for baseline in text with descenders ( 1.7a)
  243.  
  244.      1.8 : 2nd March 1996
  245.    
  246.        Allow for GDI 0x0105 ( Undocumented in 2 books )
  247.        Allow for corrupted files i.e. avoid abend when length
  248.        exceeds remaining available bytes.
  249.        Fix PolyPolygon to address values.
  250.        Remove debugging info on buffer expansion.
  251.        Fix path bounding box.
  252.  
  253.      1.8a : Fix flex bug introduced in 1.8
  254.  
  255.  
  256.      1.9 Change filetype to official B2F
  257.          Accepts filetype FFD (data) for use with CD's
  258.  
  259.